
            DataEnter, Michael Kocum
            Taborstrasse 27/23
            A-1020 Vienna
            AUSTRIA

        CIS: 70143,1667
   Internet: michael@demk.co.at
        Fax: +43/1/2143829




Introduction to MailBeamer for Microsoft Mail
---------------------------------------------

MailBeamer is a SMPT Gateway for Microsoft Mail.

MailBeamer integrates completely into MSMail and once installed, all
MSMail Clients can immediately send messages to the Internet without
installing anything on the Client side.

MailBeamer supports MIME and UUCODE and handles incoming messages
without a UNIX host or any other complicated installation.

MailBeamer supports a complete user defined address translation which can
handle nearly all address translations possible in a MSMail
environment.

MailBeamer needs only a MX record in your DNS and your are up and running.

MailBeamer consists of MailBeamer Server, which is the worker thread and
MailBeamer Admin which is used change your configuration.



System Requirements
-------------------

  Windows NT 4.0 or Windows 95 with TCP/IP installed
  Microsoft Mail, version 3.2 or
  Windows for Workgroups


How does it work
----------------

   For outgoing SMTP messages MailBeamer scans the SMTP queue on your
   postoffice and if a messages is found, MailBeamer converts it to
   MIME or UUENCODE and forwards the message to a unix host,
   which in turn does the actual job of sending the message to the
   recipient.

   Note: The "unix host" needs not to be a real unix machine.
         Basically it need to be a machine which runs "sendmail" or any
         other software that can act as a relay host.

         Usually your ISP has such a machine, but there are free NT
         programs also.



   For incoming messages MailBeamer is listening on TCP/IP port 25
   and if a mailer establishes a connection, MailBeamer creates a new
   thread for this connection, receives the message, converts the
   message from MIME or UUCODE and puts it into the mailbag of the
   MSMail recipient.

   If there is a problem with the message that MailBeamer can not
   handle, the messages is sent the person who is responsible for
   MailBeamer, so that no message is lost.



Installation
------------

   Create a directory on your machine and copy all the files into this
   directory.


   Start MBAdmin.exe to configure MailBeamer.

   On your first start you will prompted for the following information:


   "MSMail Postoffice Is Located AT"

      Type in the complete path to your postoffice or select the
      "Browse" button to browse "My Computer".

      Note: If possible use UNC names rather than drives if your
            postoffice is not on a local drive.


   "Administrator's Address"

      The address of the person who is responsible for maintaining the
      gateway. MailBeamer will send all error messages to this address.



   For a quick start you can leave all other settings at their defaults.



   After you closed the dialog by pressing "Ok" , MailBeamer verifies
   that there is a SMTP gateway installed on your postoffice.

   If no SMTP Gateway is found, MailBeamer will prompt you to install
   the SMTP Gateway on your postoffice. You need to allow MailBeamer to
   install it or MailBeamer will not work!


   Note: If you currently have a different SMTP Gateway installed which
         is completely compatible to the Microsoft Gateway, MailBeamer
         will use its queue and will not install a new one, but it will
         not use its configuration or postoffice address mapping.


   There after MailBeamer creates a default address mapping with your
   Network and postoffice and the domain "domain.com".

   You can change this to your real domain name by double clicking on
   the record in the main window.


   Now you are ready to start MBServer.exe and take a look at the screen
   to see if MailBeamer works and no error messages are displayed.


   Restart your Microsoft Mail Client and you will see a new address
   template called "SMTP". Create a new message using this SMTP template
   and fill in the address with a valid Internet address like
   "michael@demk.co.at".

   MailBeamer should pick up the message and if everything is ok, the
   message will be sent.


   Note: MailBeamer will not receive messages form the Internet until
         you create a MX record in your DNS ( Domain Name Server ) which
         points to the machine where MailBeamer is running. If you are
         unsure what a MX record is, then your ISP will be happy to
         create it for you.




Address Mapping
---------------

   Address Mapping is one of the key features of MailBeamer.


   If you have only one postoffice:

      That's the basic configuration. You will need only one record in
      the main window and MailBeamer should have created it by default.

      Change the domain from the default "domain.com" to your domain and
      your are ready to go.

      Your Internet address will be your MSMail mailbox plus the domain.

      Assume your mailbox is "Bill" and your domain is "acme.com", then
      your Internet address is "bill@acme.com".

      If you dont like this behavior, please read the section
      "User Address Mapping" below.


   If you have more postoffices:

      Note: You need to install the downstream postoffice access on the
            postoffices which MailBeamer does not scan, so that External
            will transfer the SMTP messages from the downstream
            postoffices to the main postoffice.



      You have the choice of adding one translation record for every
      postoffice you have and provide a different domain for each
      postoffice. Doing so, every postoffice has a different Internet
      address, but its absolute clear when a message arrive to which
      postoffice it should be sent.

      On the other side, you can also use the same domain for every
      postoffice. When a message arrives, MailBeamer will scan all the
      postoffice for the mailbox and send it to the postoffice.

      This however requires that your mailbox names are unique over all
      postoffices, because MailBeamer will send to the first mailbox
      that matches. This is always a problem with the "Admin" mailbox,
      because it exist on every postoffice.

      Note: If your Network is the same for all postoffices, then you
            need to create only one translation record and leave the
            postoffice field blank. MailBeamer scan then every
            downstream postoffice to find a matching mailbox.



User Address Mapping
--------------------


   By default your Internet address will be your MSMail mailbox plus the
   domain.

   Assume your mailbox is "Bill" and your domain is "acme.com", then
   your Internet address is "bill@acme.com".

   You can override this in "User Address..." by providing a complete
   SMTP address for a specific mailbox.

   If you define more than one SMPT address for the same mailbox, only
   first is used for outgoing mail, but all are used for incoming mail.



Host Encoding
-------------

   By default MailBeamer sends all messages which require a encoding
   using MIME with codepage Western European (ISO-8859-1) which is today
   standard.

   However there are old mail systems on the Internet which can not
   handle MIME. Host Encoding provides you with a way to use a different
   encoding based on a email domain.



Installing MailBeamer as a Microsoft NT Service
-----------------------------------------------

Keep in mind that MailBeamer needs to reside on a local disk or the Service
Controller can't start. For the samples below, we assume MailBeamer is
in C:\MailBeam.

Be sure that MailBeamer is running well in Console Mode and there is no
error, because once you run it as a Service, you cant see a screen and
a problem will only be visible in the log file.


There are two different install methods depending of the location of
your postoffice.


a) Your postoffice is on a local disk

   Start MailBeamer one time with an argument of "install",

   i.e. type
   MBServer install

   and MailBeamer will create the service. By default it's an AUTOSTART
   Service and any time your computer is started, MailBeamer will start.

   You can start and stop MailBeamer at any time via the "Control Panel".

   Note: In MailBeam.Ini, MailDrive= had to point to a local
         directory, NOT to a sharename,

         i.e. use  MailDrive=C:\MAILDATA
         and not  MailDrive=M



b) Your postoffice is on a network disk

   Start MailBeamer one time with an argument of "install",

   i.e. type
   MBServer install

   and MailBeamer will create the service. By default it's an AUTOSTART
   Service and any time your computer is started, MailBeamer will start.

   Note: Before you do the next part its a good idea to create
         a user "MailBeamer" on your NT machine

   Open "Control Panel", select "Services",
   locate MailBeamer and press the button labeled "Startup...".

   In section "Log On As" select "This account" and select a
   account (user) which MailBeamer should use for performing a log on into
   the network.

   The account need to have the right to "Log on as a Service".
   You can set this right when checking "Show Advanced Rights"
   in "User Manager". On NT 3.51 this is done automatic when you select
   the account.


   It's a good idea to create a user "MailBeamer" on your NT machine and
   select this user instead of a human person, because if your ever
   change the password or delete the account, MailBeamer can't no longer
   log on into the network.

   You can start and stop MailBeamer at any time via the "Control Panel".

   Note: In MailBeam.Ini, MailDrive= had to be an UNC name and not a drive.

         i.e. use  MailDrive=\\SERVER\SHARENAME
         and not  MailDrive=M

         because there is no drive mapping for a Service.



Note: After you started MailBeamer as a Service, verify that MailBeamer has no
      errors ( i.e. it have access to all your postoffices ).
      You need to take a look into the log file to do this.




Removing MailBeamer as a Microsoft NT Service ( Win32 version only )
-------------------------------------------------------------------

Start MailBeamer one time with an argument of "remove",

i.e. type
MBServer remove

and MailBeamer will delete the service.




More information
----------------

Enclosed you will find FAQ.TXT which answers frequently asked questions



Latest Version:
---------------

You will find the latest version of MailBeamer on

ftp://ftp.dataenter.co.at        or
http://www.dataenter.co.at       or
CompuServe, GO PCAPP, LIB 9

Filenames is: MailBeam.ZIP




Licensing Agreement
-------------------

    MailBeamer (c) is copyrighted 1993-1995 by DataEnter, Michael Kocum,
    portions (c) Microsoft Corp.

    This product and its documentation may not, in whole or in part, be
    copied, reproduced, transmitted, transcribed, stored in a retrieval
    system, or translated into any other natural or computer language, in
    any form or by any means whatsoever, be it electronic, mechanical,
    magnetic, optical, manual or otherwise, without the prior written
    consent of DataEnter.

    DataEnter makes no warranty or representation, either expressed or
    implied, with respect to the product MailBeamer and its
    documentation, their quality, performance, merchantability, or
    fitness for a particular purpose. DataEnter reserves the right to
    revise the user's guide and make changes in the content without
    obligation to notify any person or organization of such a change.

    In no event will DataEnter be liable for any direct, indirect,
    special, incidental or consequential damages, real or imagined,
    resulting from the use or purchase of this software.
    Under no circumstances shall DataEnter's liability for damages
    exceed the price paid for the software license.

    Should any remedy hereunder be determined to have failed, all
    limitations of liability and exclusion of damages set forth above
    shall remain in full force and effect.

    The extent of the DataEnter's warranty for the software and its
    documentation is limited to physical defects of the distribution media
    containing the software. Contact DataEnter to obtain return
    authorization for the replacement diskette within 30 days of the
    original date of purchase. Any further statement made by agents,
    employees, distributors or dealers of DataEnter do not constitute
    warranties and are not binding. No employee of DataEnter has the
    authority to modify any portion of this warranty.

    All brand and product names we refer to in the documentation are used
    solely for identification purposes and may be trademarks of other
    companies.

    DataEnter, (the licensor) grants the buyer (the licensee) the right
    to use this copy of MailBeamer (the program) on a single computer at
    a single location as long as the licensee complies with the terms of
    this license.

    The licensor reserves the right to terminate this license if the
    licensee violates any part of the agreement.

    The licensee agrees to make copies of the program only for backup
    purposes. The licensee agrees not to copy the documentation and to
    take all necessary precautions to ensure that the backup copies of the
    software are not distributed to or acquired by other parties.

    Microsoft Mail is a trademark of Microsoft Corp.
    Windows for Workgroups is a trademark of Microsoft Corp.


Server History:
---------------

v3.00  97-05-28  Released



Admin History:
--------------

v3.00  97-05-05  Released

